From 8d503f2a90ae5e5f3aa1fb488148c10aca8a4b0b Mon Sep 17 00:00:00 2001 From: "20:21:28 Tim Janik" Date: Mon, 1 Oct 2007 18:21:54 +0000 Subject: [PATCH] reworded push_in description with Owen's help, fixes bug #482034. 2007-10-01 20:21:28 Tim Janik * gtk/tmpl/gtkmenu.sgml: reworded push_in description with Owen's help, fixes bug #482034. svn path=/trunk/; revision=18872 --- docs/reference/ChangeLog | 5 +++++ docs/reference/gtk/tmpl/gtkmenu.sgml | 12 ++++++++++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 281b1edf9c..c8dc457376 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2007-10-01 20:21:28 Tim Janik + + * gtk/tmpl/gtkmenu.sgml: reworded push_in description with Owen's + help, fixes bug #482034. + 2007-09-13 Matthias Clasen * === Released 2.12.0 === diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml index 18f7fec9d1..7fde58e579 100644 --- a/docs/reference/gtk/tmpl/gtkmenu.sgml +++ b/docs/reference/gtk/tmpl/gtkmenu.sgml @@ -394,8 +394,16 @@ and @y parameters to the coordinates where the menu is to be drawn. menu shall be drawn. This is an output parameter. @y: address of the #gint representing the vertical position where the menu shall be drawn. This is an output parameter. -@push_in: whether the first menu item should be offset (pushed in) to be - aligned with the menu popup position (only useful for GtkOptionMenu). +@push_in: This parameter controls how menus placed outside the monitor are handled. + If this is set to TRUE and part of the menu is outside the monitor then + GTK+ pushes the window into the visible area, effectively modifying the + popup position. + Note that moving and possibly resizing the menu around will alter the + scroll position to keep the menu items "in place", i.e. at the same monitor + position they would have been without resizing. + In practice, this behavior is only useful for combobox popups or option + menus and cannot be used to simply confine a menu to monitor boundaries + (in which case the scroll offset shouldn't be changed). @user_data: the data supplied by the user in the gtk_menu_popup() @data parameter. -- 2.30.2